home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / utils / stogl140.arj / SCRNTOGL.DOC < prev    next >
Text File  |  1993-06-16  |  8KB  |  181 lines
  1.                                SCRNTOGL 1.40
  2.  
  3.                                      by
  4.  
  5.                               Roland J Skinner
  6.  
  7.                              Copyright (c) 1993
  8.  
  9.                                 RJS Software
  10.  
  11.  
  12. SCRNTOGL is a memory resident utility to toggle the screen on and off.
  13.  
  14. It provides the ability to switch off the screen manually, to keep "secret"
  15. information  from  prying  eyes of people entering one's office, etc. while
  16. working on a confidential document, program, etc.; or even keeping a person
  17. with  whom  you are speaking from losing his/her full attention by watching
  18. what is on your monitor.
  19.  
  20. Also,  it  provides  a "screen-saver" - saves the phosphor in the monitor -
  21. which  will  toggle  the  screen  off after a certain time-interval with no
  22. keyboard, mouse or joystick action.
  23.  
  24. The format for executing SCRNTOGL is:
  25.  
  26.     SCRNTOGL [[[delay] [/KEY=key] [/LOADHIGH] | [/UNINSTALL | /U] |
  27.                [/ENABLE] | [/DISABLE] | [/SCRNON] | [/SCRNOFF]
  28.               ] [/QUIET | /Q] | [/HELP | /?]
  29.  
  30. Here,  "delay"  is  an  optional  command-line  parameter,  which  sets the
  31. time-interval,   in   minutes   (from  1  to  30),  before  the  screen  is
  32. automatically "switched-off".
  33.  
  34. "/KEY=" is the parameter used to customize the toggle-key  to  "key".  Note
  35. that by default, this key is ESC. Where the documentation uses  ESC  below,
  36. simply substitute one's own key. "key" is of the form [...], where  "[...]"
  37. is one of the following:
  38.  
  39. [Esc] [F1] [F2] [F3] [F4] [F5] [F6] [F7] [F8] [F9] [F10] [F11] [F12] [Scroll]
  40. [`] [1] [2] [3] [4] [5] [6] [7] [8] [9] [0] [-] [=] [\] [BckSpc] [PrtSc]
  41. [Tab] [Q] [W] [E] [R] [T] [Y] [U] [I] [O] [P] [[] []] [Enter]
  42. [Caps] [A] [S] [D] [F] [G] [H] [J] [K] [L] [;] [']
  43. [LShift] [Z] [X] [C] [V] [B] [N] [M] [,] [.] [/] [RShift]
  44. [Ctrl] [Alt] [Space]
  45. [Num] [#7] [#8] [#9] [#-]
  46.       [#4] [#5] [#6] [#+]
  47.       [#1] [#2] [#3]
  48.       [#0] [#.]
  49.  
  50. Note, certain of the keys above are not allowed.  These  keys  are  [Ctrl],
  51. [Alt], [LShift] and [RShift]. Note also that certain of  the  keys  on  the
  52. 101-keyboard are not supported.
  53.  
  54. "/LOADHIGH" is used to load SCRNTOGL high. One  requires  some  UMB-manager
  55. installed in order to do this.
  56.  
  57. And, "/UNINSTALL" or "/U" is the parameter which is used to remove SCRNTOGL
  58. from memory (only if it is safe to do so).
  59.  
  60. "/ENABLE" will enable SCRNTOGL, and "/DISABLE" will disable  SCRNTOGL.  See
  61. below for a short discussion on enabling and disabling.
  62.  
  63. "/SCRNON" will toggle the screen on, and "/SCRNOFF" will toggle it off.
  64.  
  65. The "/QUIET" or "/Q" parameter may be  used  to  suppress  all  display  of
  66. messages, except in the case of an error.
  67.  
  68. "/HELP" or "/?" may be used to get a help-screen.
  69.  
  70. If no parameter is given, or only "/LOADHIGH" is used, with or without "/Q"
  71. or "/QUIET", SCRNTOGL defaults to a time-interval of 5 minutes.
  72.  
  73. If an invalid parameter  or  incorrectly  used  parameter  is  given,  then
  74. SCRNTOGL  will  do nothing, and exit with an appropriate message describing
  75. what went wrong.
  76.  
  77. Note,  SCRNTOGL checks whether it is already in memory, and ensures that it
  78. cannot  be loaded more than once. If an attempt to reload SCRNTOGL, once it
  79. is  already  resident,  is  made, then SCRNTOGL will, once again, exit with
  80. an  appropriate message. Also, if one tries to "uninstall" SCRNTOGL, and it
  81. is not resident, then it will exit will such a message.
  82.  
  83. Toggle-keys are as follows:
  84.  
  85.         *  ALT-ESC              Switch the screen off manually.
  86.         *  CTRL-ESC             Switch  the screen back on after the screen
  87.                                 has been manually or automatically switched
  88.                                 off.
  89.         *  ALT-LSHFT-RSHFT-ESC  Disable or enable SCRNTOGL.
  90.  
  91. One  may  require  that  SCRNTOGL be disabled during certain programs, e.g.
  92. applications  that  take-over  keyboard access (which prevent SCRNTOGL from
  93. working  properly),  and the sequence  ALT-LSHFT-RSHFT-ESC  can be used for
  94. this  purpose.  When  disabling  SCRNTOGL, a long high-pitched beep will be
  95. heard,  indicating  a  disabled  SCRNTOGL, as opposed to the shorter lower-
  96. pitched beep, indicating an enabled SCRNTOGL.
  97.  
  98. An  additional  advantage that SCRNTOGL provides is that when the screen is
  99. switched  off, it also prevents unwanted people from accessing the computer
  100. by  trying  to  reboot  the  computer  -  other  than switching it off (you
  101. probably  have  a  password-routine, if you're security conscious) - as the
  102. CTRL-ALT-DEL  sequence is temporarily disabled.
  103.  
  104. It has been found that with some mouse-drivers, SCRNTOGL needs to be loaded
  105. before that mouse-driver, such as GMOUSE v10.10. So, if SCRNTOGL  does  not
  106. toggle the screen off after some delay  of  no  activity,  simply  load  it
  107. before your mouse-driver.
  108.  
  109. Note,  when  using  a  joystick, SCRNTOGL will only check for either of the
  110. fire-buttons  being  pressed.  This  is because if it were to try to detect
  111. direction  changes,  conflict  between  SCRNTOGL and a program - probably a
  112. game - that uses the joystick would occur.
  113.  
  114. SCRNTOGL  does not occupy a great deal of memory when resident - in fact it
  115. currently uses only 944 bytes when it loads itself high, otherwise it  uses
  116. 1040 bytes - and so should not be a problem in a memory-tight system.
  117.  
  118. I hope you, the user, will appreciate this utility as much as I have.
  119.  
  120. Roland Skinner
  121.  
  122. P.O. Box 14134
  123. BREDELL
  124. 1623
  125. REPUBLIC OF SOUTH AFRICA
  126.  
  127. EMail:
  128.   InterNet: roland@concave.cs.wits.ac.za
  129.             roland.skinner@p1.f55.n7101.z5.fidonet.org
  130.   FidoNet:  Roland Skinner @ 5:7101/55.1
  131.  
  132. P.S. For  any  enquiries,  donations,  reports  on  bugs,  etc.  I  may  be
  133.      contacted at any of the above addresses.
  134.  
  135. -------------------------- Note to programmers ----------------------------
  136.  
  137. As of v1.40, a programming API for SCRNTOGL  has  been  included  with  the
  138. program. The API is in the file "SCRNTOGL.API".
  139.  
  140. ---------------------------------------------------------------------------
  141.  
  142. Please note, SCRNTOGL is FREEWARE, and it is safe! You may use it until you
  143. get sick of it. SCRNTOGL is not a fancy screen-saver, but it gets  the  job
  144. done - minimal memory usage is important an important factor in its design.
  145.  
  146. -------------------------- History of SCRNTOGL ----------------------------
  147.  
  148. *  SCRNTOGL 1.00  (10 July 1991)
  149.  
  150.    Initial release.
  151.  
  152. *  SCRNTOGL 1.10  (11 September 1991)
  153.  
  154.    Fixed a "bug" in which SCRNTOGL would, if the  screen  border  were  any
  155.    colour other than black, blank the screen to that colour. Now,  SCRNTOGL
  156.    will blank the screen to black and later, when  the  screen  is  toggled
  157.    back on, restore the screen border to its initial colour.
  158.  
  159. *  SCRNTOGL 1.20 (1 December 1991)
  160.    Major rewrite of SCRNTOGL. SCRNTOGL has been  optimized  for  speed  and
  161.    size. SCRNTOGL is much smaller than before and also has added  features.
  162.    SCRNTOGL can now be loaded high (as before), and can now detect  whether
  163.    it is loaded high - before, if  SCRNTOGL  was  loaded  high,  one  could
  164.    load it more  than  once.  Also,  the  introduction  of  a  programming-
  165.    interface has been implemented. The next release will take advantage  of
  166.    this interface, and include support programs which can be used in batch-
  167.    files, etc. to, for example, toggle the screen on  or  off,  disable  or
  168.    enable SCRNTOGL.
  169.  
  170. *  SCRNTOGL 1.30 (Early 1992 - when, I can't remember - it is now mid '93)
  171.    Added many new options. Including enabling and  disabling  of  SCRNTOGL,
  172.    toggling the screen on and off, setting the toggle-key,  a  quiet  mode,
  173.    and on-line help. Also included was the  ability  to  load  itself  high
  174.    under DOS 5.00 (or above).
  175.  
  176. *  SCRNTOGL 1.40 (16 June 1993)
  177.    Corrected problem with SCRNTOGL not working on Mono-VGAs.
  178.    Added generic support for loading high.  SCRNTOGL  now  works  with  any
  179.    UMB-manager that supports the XMS specification.
  180.    Provided API documentation for programmers.
  181.